home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 23 / AMIGAplus Sonderheft 23 (2000)(Falke)(DE)[!].iso / Tools / Scout / help / english / scout.doc < prev    next >
Text File  |  1999-11-06  |  70KB  |  2,289 lines
  1.  
  2.                              Scout 37.204
  3.                              Release 2.10
  4.                             User's Manual
  5.           Copyright (C) 1994-97 Andreas Gelhausen, Richard Körber
  6.  
  7. What is Scout?
  8. ==============
  9.  
  10.        Scout is a tool that allows you to monitor your computer
  11. system.  It displays many different things -- like tasks, ports,
  12. assigns, expansion boards, resident commands, interrupts, etc.  -- and
  13. you can perform some certain actions on them.
  14.  
  15.    For example you can freeze tasks, close windows and screens, release
  16. semaphores or remove locks, ports and interrupts.
  17.  
  18. Through AmiTCP it's also possible to use Scout as an TCP/IP service.
  19.  
  20.    Since version 2.0 of Scout you can use nearly all implemented
  21. functions through shell parameters. Therefore it's not necessary to
  22. install MUI for using Scout, but you will need MUI, if you want
  23. to use Scout with its graphical user interface.
  24.  
  25. Copyright
  26. =========
  27.  
  28.    Please read the following parts carefully. You accept the following
  29. terms by starting the software, even for a test drive only.
  30.  
  31. COPYRIGHT
  32.      Scout 37.204 (Release 2.10) - Copyright (C) 1994-97 by Andreas
  33.      Gelhausen and Richard Körber, all rights reserved.
  34.  
  35.      You only have the right to use the software, but no rights on the
  36.      software itself. Disassembling, resourcing and all other ways of
  37.      reverse engineering is forbidden.
  38.  
  39. FREEWARE
  40.      Scout is FreeWare. You are allowed to use the packet without
  41.      paying a fee or similar to the authors. Of course we would
  42.      appreciate a small donor! ;-)
  43.  
  44. COPYING
  45.      You can copy the packet as long as it remains entire and unchanged.
  46.  
  47.      You are allowed to compress the packet using a customary
  48.      compression software (as lha, lzh, lzx, dms). You must not
  49.      compress single files of the packet (e.g. PowerPacker or Imploder).
  50.  
  51. DISTRIBUTION
  52.      You must not exceed an usual price on the market for your working
  53.      and material. This means a maximum of 5 DM (or the equivalent
  54.      amount in other currencies, including all taxes) for disks and 35
  55.      DM for CD-ROMs containing a PD software collection.
  56.  
  57.      In any case, you need a written permission from us if you want to
  58.      include Scout on a cover disk or in connection with a commercial
  59.      product.
  60.  
  61.      We explicitly permit the distribution via AmiNet, Meeting Pearls
  62.      and Fred Fish.
  63.  
  64. LIABILITY
  65.      You are using the program as it is, with all flaws, and on your
  66.      own risk! We grant no warranty for the software meeting a special
  67.      purpose. This software may cause financial damage or harm people.
  68.  
  69. LIMITATIONS
  70.      You are not allowed to use this software and its results
  71.  
  72.         * for fascism or military purposes
  73.  
  74.         * if you do not agree to the copyright note
  75.  
  76.      In this case you must delete the software and all related and
  77.      generated files immediately!
  78.  
  79. CONTENTS OF THE PACKET
  80.      The Scout packet is only entire with these files:
  81.           Scout/arexx/activatetask.scout
  82.           Scout/arexx/arexx.readme
  83.           Scout/arexx/arexx.readme.info
  84.           Scout/arexx/breaktask.scout
  85.           Scout/arexx/freezetask.scout
  86.           Scout/arexx/poptofront.scout
  87.           Scout/arexx/settaskpri.scout
  88.           Scout/arexx/startup.scout
  89.           Scout/arexx.info
  90.           Scout/help/deutsch/scout-39.guide
  91.           Scout/help/deutsch/scout-39.guide.info
  92.           Scout/help/deutsch/scout.doc
  93.           Scout/help/deutsch/scout.doc.info
  94.           Scout/help/deutsch/scout.dvi
  95.           Scout/help/deutsch/scout.guide
  96.           Scout/help/deutsch/scout.guide.info
  97.           Scout/help/deutsch.info
  98.           Scout/help/english/scout-39.guide
  99.           Scout/help/english/scout-39.guide.info
  100.           Scout/help/english/scout.doc
  101.           Scout/help/english/scout.doc.info
  102.           Scout/help/english/scout.dvi
  103.           Scout/help/english/scout.guide
  104.           Scout/help/english/scout.guide.info
  105.           Scout/help/english.info
  106.           Scout/help.info
  107.           Scout/icons/icons.readme
  108.           Scout/icons/icons.readme.info
  109.           Scout/icons/Scout.info
  110.           Scout/icons/ScoutDock
  111.           Scout/icons/ScoutDock.info
  112.           Scout/icons.info
  113.           Scout/libs/identify.library
  114.           Scout/libs/identify.readme
  115.           Scout/libs/identify.readme.info
  116.           Scout/libs.info
  117.           Scout/Product-Info
  118.           Scout/Scout
  119.           Scout/Scout.info
  120.           Scout/scout.history
  121.           Scout/Scout.history.info
  122.           Scout/Scout.readme
  123.           Scout/Scout.readme.info
  124.           Scout.info
  125.  
  126. TRADEMARKS
  127.      All copyrights and trademarks are held by their owners.
  128.  
  129. System Requirements
  130. ===================
  131.  
  132.     Scout only requires Amiga operating system version 2.04.  The
  133. identify.library V8 is not required, but I strongly suggest to
  134. install it to give Scout its full power.  See also Identify.
  135.  
  136.    If you want to use Scout's graphical user interface, you also have
  137. to install MUI version 2.1 or higher.  See also MUI.
  138.  
  139.    The TCP/IP features of Scout are only available, if you have
  140. installed the version 4.0 of AmiTCP.  See also AmiTCP.
  141.  
  142. MUI - MagicUserInterface
  143. ========================
  144.  
  145.              (C) Copyright 1992-97 by Stefan Stuntz
  146.  
  147.    MUI is a system to generate and maintain graphical user interfaces.
  148. With the aid of a preferences program, the user of an application has
  149. the ability to customize the outfit according to his personal taste.
  150.  
  151.    MUI is distributed as shareware. To obtain a complete package
  152. containing lots of examples and more information about registration
  153. please look for a file called muiXXusr.lha (XX means the latest
  154. version number) on your local bulletin boards or on public domain disks.
  155.  
  156.    If you want to register directly, feel free to send DM 30.- or US$
  157. 20.- to
  158.  
  159.                         Stefan Stuntz
  160.                    Eduard-Spranger-Straße 7
  161.                         80935 München
  162.                            GERMANY
  163.  
  164. Identify
  165. ========
  166.  
  167.              Copyright (C) 1996-97 Richard Körber
  168.  
  169.        Identify is a Shared Library that decodes expansion IDs, guru
  170. codes and library functions, and identifies your system.
  171.  
  172.        Identify is FreeWare. You can find a complete package in the
  173. AmiNet (util/libs/Identify.lha) or on the author's home page:
  174. http://www.is-koeln.de/einwohner/shred/. To get in contact, write
  175. to shred@chessy.aworld.de.
  176.  
  177. AmiTCP
  178. ======
  179.  
  180.        AmiTCP is a TCP/IP protocol stack for the Amiga. The demo
  181. version 4.0 (or higher) should be available in greater public domain
  182. collections or on the AmiNet. Ask your preferred Amiga dealer.  =:^)
  183.  
  184. Installing Scout
  185. ================
  186.  
  187.    You only have to copy the program scout to your favourite
  188. directory, and identify.library to libs:. Then you can start it.
  189.  
  190. How to use Scout
  191. ****************
  192.  
  193.    This chapter describes the usage of Scout through its graphical
  194. user interface. This graphical user interface is based on the Magic
  195. User Interface (MUI) and MUI have to be installed in your system,
  196. if you want to use Scout trough windows and so on.
  197.  
  198.    If you don't like MUI, you should see Scout without MUI.
  199.  
  200.    If you start the program you will see the main window which includes
  201. many gadgets.  Each of these gadgets represents a certain kind of
  202. system structure.
  203.  
  204. You can choose between:
  205.  
  206.    Allocations, Assigns, BoopsiClasses, Commodities, Devices,
  207. Expansions, Fonts, InputHandlers, Interrupts, Libraries, Locks,
  208. LowMemory, Memory, Mounted Devices, Ports, Resident Commands,
  209. Residents, Resources, ScreenMode, Semaphores, System, Tasks, Timer,
  210. Vectors and Windows.
  211.  
  212.    Click one of these gadgets and another window will be opened with a
  213. list of the structure type that is indicated on the pressed gadget.
  214.  
  215.          Example: Press the task gadget and you will get a window with
  216.      the list of tasks and processes.
  217.  
  218.    You can also select these functions by pressing the underlined key
  219. you see on each gadget or by using the right mousebutton menu.
  220.  
  221.    If you wish to handle/remove a given structure, you should know what
  222. you do.
  223.  
  224.          Warning: Wrong handling of the showed structures can crash
  225.      your system. At the worst you will lose your data.
  226.  
  227.     Please note: You should not be surprised, if you don't find a
  228. certain detail information in this manual, because it's to much work to
  229. explain each element of all the structures you could see in this
  230. program.
  231.  
  232.    Many books are written about these things and if you want to have
  233. more information about them, you should have a look in the specialized
  234. literature.
  235.  
  236. Allocations
  237. ===========
  238.  
  239.    This window informs about who allocated what hardware resource.
  240.  
  241. CIA
  242. ---
  243.  
  244.    The Amiga owns two CIA to control its hardware, the keyboard and the
  245. printer interfaces. Additionally, it contains a couple of timer.  This
  246. window shows which parts of the CIA are not yet allocated, or which
  247. program allocated the resource.
  248.  
  249. Timer A
  250. Timer B
  251.      This are two 16bit timer. They can also be coupled to a 32bit
  252.      timer.
  253.  
  254. Alarm
  255.      This resource informs if a third timer reached an alarm value.
  256.  
  257. Serial
  258.      This is a simple serial interface. Usually, the CIA-A one's is used
  259.      for communicating with the keyboard. The CIA-B serial interface
  260.      will not be allocated in most cases.
  261.  
  262. Flag
  263.      This is a special control line. It is connected from the CIA-A to
  264.      the Index line of the floppy disk drives.
  265.  
  266.    Note: newer DraCos do not contain the CIA chips. Thus, these
  267. hardware resources will be emulated or are even not offered.
  268.  
  269. Ports
  270. -----
  271.  
  272.    This are the resources for the internal parallel and serial
  273. interfaces.
  274.  
  275. Serial Port
  276.      This are the plain data transfer registers (transmitting and
  277.      receiving).
  278.  
  279. Serial Control
  280.      This are the serial control lines, as Carrier Detect.
  281.  
  282. Parallel Port
  283.      This are the data lines of the parallel port.
  284.  
  285. Parallel Control
  286.      This are the control lines of the parallel port, as Busy or Paper
  287.      Out.
  288.  
  289. Actions
  290. -------
  291.  
  292. Update
  293.      The window is updates each time you press this button.
  294.  
  295. Print
  296.      The window's contents are printed or saved to a file of your
  297.      choice.
  298.  
  299. Exit
  300.      The window will be closed.
  301.  
  302. Assigns
  303. =======
  304.  
  305.    This type of structure assigns a logical name to a directory.
  306.  
  307.    If you assign the directory dh0:data/documents the logical name
  308. texts:, you will also be able to choose a file filename in that
  309. directory with the path `texts:filename'.
  310.  
  311. Column items
  312. ------------
  313.  
  314. Address
  315.      Address of the assign structure.
  316.  
  317. Name
  318.      Logical name of a directory
  319.  
  320. Path
  321.      Here you will find the path of the directory.
  322.  
  323. Actions
  324. -------
  325.  
  326. Update
  327.      Selecting this gadget updates the list of assigns.
  328.  
  329. Print
  330.      This function allows you to send the list of Assigns to printer
  331.      or a selected file.
  332.  
  333. Remove
  334.      The selected assign will be removed with this function.
  335.  
  336. Exit
  337.      The Assigns window will be closed.
  338.  
  339. BoopsiClasses
  340. =============
  341.  
  342. BOOPSI classes are object oriented classes. The classes in this list
  343. are all classes that are publically available from intuition.
  344.  
  345. Column items
  346. ------------
  347.  
  348. Address
  349.      This is the address of the IClass structure, which contains all
  350.      data of this class.
  351.  
  352. Objects
  353.      Shows the current amount of objects constructed by this class.
  354.  
  355. Subclasses
  356.      Shows the current amount of sub classes (public and private) which
  357.      are derived from this class.
  358.  
  359. Superclass
  360.      A pointer to the IClass structure of the parent class.
  361.  
  362. Dispatcher
  363.      A pointer to the dispatcher code, which realizes all methods of
  364.      the class.
  365.  
  366. Name
  367.      The name of the class.
  368.  
  369. Actions
  370. -------
  371.  
  372. Update
  373.      The list will be updated.
  374.  
  375. Print
  376.      This function allows you to send the list to printer or a selected
  377.      file.
  378.  
  379. Remove
  380.      Removes the selected class from the system. This is only possible
  381.      if neither objects nor sub classes exist from this class.
  382.  
  383. More
  384.      Opens a window with further information.
  385.  
  386. Exit
  387.      Closes the window.
  388.  
  389. Commodities
  390. ===========
  391.  
  392. Commodities are small utilities. Most of them react on the input
  393. stream, or manipulate it.
  394.  
  395.    You can find some commodity examples in the Tools drawer of your
  396. Workbench.
  397.  
  398. Column items
  399. ------------
  400.  
  401. Address
  402.      Points to the CxObj structure of the commodity, containing all
  403.      data about it.
  404.  
  405. ln_Type
  406.      Structure type. Usually, it will be Broker.
  407.  
  408. ln_Pri
  409.      Priority of the commodity broker.
  410.  
  411. Flags
  412.      Flags describing the broker.
  413.  
  414. Port
  415.      All messages of the broker are sent to this MessagePort.
  416.  
  417. Name
  418.      Name of the commodity.
  419.  
  420. Actions
  421. -------
  422.  
  423. Appear
  424. Disappear
  425.      Let the selected commodity's GUI pop up or disappear. Some
  426.      commodities do not have a GUI.
  427.  
  428. Enable
  429. Disable
  430.      The commodity will be enabled or disabled.
  431.  
  432. Kill
  433.      Let the selected commodity remove itself in a clean way.
  434.  
  435. ListChg
  436. Unique
  437.      The commodity is notified that the list has been changed or that
  438.      another commodity with the same name was about to be added. This
  439.      is only useful for programmers to test out their commmodities.
  440.  
  441. Update
  442.      The list will be updated.
  443.  
  444. Print
  445.      This function allows you to send the list to printer or a selected
  446.      file.
  447.  
  448. Priority
  449.      This function allows you to change the priority of a commodity.
  450.  
  451. Remove
  452.      Removes the selected commodity from the system. Please try a
  453.      frienly remove before, using Kill. Maybe the commodity removes
  454.      itself voluntarily. =;^)
  455.  
  456. More
  457.      Opens a window with further information.
  458.  
  459. Exit
  460.      Closes the window.
  461.  
  462. Devices
  463. =======
  464.  
  465.    A device is -- like a library (see Libraries) -- a collection of
  466. functions/procedures, which have to do certain jobs.
  467.  
  468.    E.g. the trackdisk.device includes functions for the floppy disk
  469. handling.
  470.  
  471. Column items
  472. ------------
  473.  
  474. Address
  475.      Address of the device structure
  476.  
  477. ln_Name
  478.      Name of a device
  479.  
  480. ln_Pri
  481.      Priority of a device
  482.  
  483. OpenC
  484.      This element shows how often the device was opened.
  485.  
  486. RPC
  487.          RPC means RAM Pointer Count and shows how many jump
  488.      addresses of the device point into RAM.  In this way many programs
  489.      -- like the setpatch command from Commodore -- patch the system.
  490.  
  491.      Many viruses patch the system in this way too, but don't panic now.
  492.      If you check your system in regular intervals with a current virus
  493.      killer, it should be out of danger.
  494.  
  495.      If the whole program code of the device is located in RAM, you will
  496.      find a dash (minus sign) here, because in this case it's
  497.      unimportant how many jump addresses point into RAM.
  498.  
  499. ln_Type
  500.      Type of this structure (usually device)
  501.  
  502. Actions
  503. -------
  504.  
  505. Update
  506.      If you select this gadget, the list of devices will be updated.
  507.  
  508. Print
  509.      This function allows you to send the list of Devices to printer
  510.      or a selected file.
  511.  
  512. Remove
  513.      The selected device will be removed with this function provided
  514.      that no program uses this device anymore and the OpenC is zero.
  515.  
  516. Priority
  517.      Herewith the priority of the device can be changed.  A little
  518.      window will be opened, that asks you for a new priority.  Through
  519.      the new priority it can happen that the device gets a new place in
  520.      the device list.
  521.  
  522. More
  523.      Another window will be opened and you will see more informations
  524.      about the selected device.
  525.  
  526.      You will have the same effect, if you doubleclick an element of the
  527.      device list.
  528.  
  529. Functions
  530.      All device function offsets and addresses are shown up in a
  531.      subwindow.  If an appropriate .fd file exists and an FD:
  532.      assign points to its directory, then you will also see the
  533.      function names.
  534.  
  535. Exit
  536.      The Devices window will be closed.
  537.  
  538. Expansions
  539. ==========
  540.  
  541.        IMPORTANT: All Scout releases before 2.10 are not compatible
  542. to this release! So if you want to read this list using TCP/IP, make
  543. sure that the remote system runs the latest version as well!
  544.  
  545.    This window shows a list about all your expansion boards (graphic
  546. boards, memory expansions and so on) too.
  547.  
  548. Column items
  549. ------------
  550.  
  551. Address
  552.      The address of the expansion structure.
  553.  
  554. BoardAddr
  555.      Usually you will find the ROM of the card here.  If this address
  556.      points into RAM, the card is a memory expansion.
  557.  
  558. Type
  559.      Information about the board. See the More window for further
  560.      information.
  561.  
  562. Manufacturer
  563.      Name of the board manufacturer.
  564.  
  565. Product
  566.      Name and class of the product.
  567.  
  568. Additional information
  569. ----------------------
  570.  
  571.    If you select one item from the list, the text field below shows up
  572. some additional information:
  573.  
  574. Size
  575.      If the entry belongs to a memory expansion, the size of the memory
  576.      is displayed here.  Otherwise it's the ROM size of the card.
  577.  
  578. Flags
  579.      See the More window.
  580.  
  581. ID
  582.      ManufacturerID, assigned by Commodore, followed by the
  583.      Productnumber, assigned by the manufacturer of the board.
  584.  
  585. SN
  586.      Serialnumber of the card (usually unused)
  587.  
  588. Actions
  589. -------
  590.  
  591. Print
  592.      This function allows you to send the list of Expansions to
  593.      printer or a selected file.
  594.  
  595. More
  596.      Now a window will be opened, that includes more informations about
  597.      the selected expansion board.
  598.  
  599.      Doubleclick an element of the Expansions list and you will have
  600.      the same effect.
  601.  
  602. Exit
  603.      The Expansions window will be closed.
  604.  
  605. Unknown expansion boards
  606. ------------------------
  607.  
  608.    If you select an expansion board by selecting its list item, you will
  609. get the name of the manufacturer and the card in the textfield you find
  610. below the list, provided that the installed version of
  611. identify.library knows about these data.
  612.  
  613.    If no information is available in this textfield or the given
  614. information is wrong, you should send me the following data, please.
  615.  
  616.      1. ManufacturerID (Manufacturer)
  617.      2. ProductID (Product)
  618.      3. Name of the company
  619.      4. Name of your expansion card
  620.      5. Function of your card
  621.  
  622.    If you send me these data, the next version of Identify will
  623. include your expansion boards. Please be as precise you can.
  624.  
  625. Fonts
  626. =====
  627.  
  628. This function will show you all fonts existing in your system.
  629.  
  630. Column items
  631. ------------
  632.  
  633. YSize
  634.      Vertical size of the font
  635.  
  636. Count
  637.      Here you can see how many programs use the font.
  638.  
  639. Type
  640.          ROMFONT means the font is located in ROM and DISKFONT
  641.      means the font was loaded from disk/harddisk.
  642.  
  643. Name
  644.      Name of the font
  645.  
  646. Actions
  647. -------
  648.  
  649. Update
  650.      The list of fonts will be updated.
  651.  
  652. Print
  653.      This function allows you to send the list of Fonts to printer or
  654.      a selected file.
  655.  
  656. Close
  657.      The font will be closed by using this function.
  658.  
  659. Remove
  660.      It is possible to remove a font from system, provided that no
  661.      program uses it and it's no ROMFONT.
  662.  
  663. Exit
  664.      The Fonts window disappears.
  665.  
  666. InputHandlers
  667. =============
  668.  
  669.    Input handlers take care of all user input arriving in system
  670. (pressed keys, mouseclicks, inserted disks, etc.). They stand one
  671. behind the other like on a production line and analyze the user input.
  672. The input handler with the highest priority gets the `events' first and
  673. if it doesn't know how to react on these `events', the second input
  674. handler gets them, and so on.
  675.  
  676.    Usually the system input handler has a priority of 50.  Every input
  677. handler, that wants to get the user input before the system, must have
  678. a higher priority.
  679.  
  680. Column items
  681. ------------
  682.  
  683. ln_Name
  684.      Name of the input handler
  685.  
  686. ln_Pri
  687.      Its priority
  688.  
  689. is_Data
  690.      This address points to some data needed by the input handler.
  691.  
  692. is_Code
  693.      The program code starts here.  If the code is located in RAM, the
  694.      address is of different color.  Otherwise you can find the code in
  695.      ROM.  Some viruses install an input handler in system.  In this
  696.      case the is_Code address points into RAM, but many other
  697.      programs uses input handlers, too.  Don't panic!
  698.  
  699. Actions
  700. -------
  701.  
  702. Update
  703.      The list of input handlers will be updated when you select this
  704.      gadget.
  705.  
  706. Print
  707.      This function allows you to send the list of InputHandlers to
  708.      printer or a selected file.
  709.  
  710. Remove
  711.      Removes an input handler from system.
  712.  
  713. Priority
  714.      Changes the priority of an input handler.
  715.  
  716. Exit
  717.      The window will be closed.
  718.  
  719. Interrupts
  720. ==========
  721.  
  722.    Interrupts are important events the computer system has to react on.
  723. It exists a list of interrupt routines for each interrupt type. If a
  724. certain interrupt occurs, all these interrupt routines will be called.
  725. During their execution the running program will be interrupted.
  726.  
  727. Column items
  728. ------------
  729.  
  730. ln_Name
  731.      Name of the interrupt
  732.  
  733. ln_Pri
  734.      Its priority
  735.  
  736. is_Data
  737.      At this address you find the data of the interrupt.
  738.  
  739. is_Code
  740.      Address of the interrupt code.  If this address points into RAM,
  741.      it's of a different color.
  742.  
  743. NUM
  744.      This number represents the type of event the interrupt routine is
  745.      called on.  The IntName you find in the interrupt detail window
  746.      gives you a little bit more information about it.
  747.  
  748.          Example: Number 5 means that the interrupt is called at every
  749.      vertical blank interval.
  750.  
  751. Actions
  752. -------
  753.  
  754. Update
  755.      The list of interrupts will be updated.
  756.  
  757. Print
  758.      This function allows you to send the list of Interrupts to
  759.      printer or a selected file.
  760.  
  761. Remove
  762.      If the interrupt is a server you can remove it from system.  An
  763.      interrupt handler can't be removed by Scout.
  764.  
  765.      If you call avail flush and the audio.device isn't used, the
  766.      interrupt handlers of the audio.device will be removed.
  767.  
  768. More
  769.      Now a window will be opened that includes more details of the
  770.      interrupt.
  771.  
  772. Exit
  773.      Selecting this gadget will close the Interrupts window.
  774.  
  775. Libraries
  776. =========
  777.  
  778.    A library is a collection of functions/procedures, which have to do
  779. certain jobs. E.g. the `graphics.library' includes routines for
  780. graphical display.
  781.  
  782. Column items
  783. ------------
  784.  
  785. Address
  786.      Adress of the library structure
  787.  
  788. ln_Name
  789.      Name of a library
  790.  
  791. ln_Pri
  792.      Priority of a library
  793.  
  794. OpenC
  795.      Here you see, how often the library was opened.
  796.  
  797. RPC
  798.          RPC means RAM Pointer Count and shows how many jump
  799.      addresses of the library point into RAM.  In this way many programs
  800.      -- like the setpatch command from Commodore -- patch the system.
  801.  
  802.      Many viruses patch the system in this way too, but don't panic now.
  803.      If you check your system in regular intervals with a current virus
  804.      killer, it should be out of danger.
  805.  
  806.      If the whole program code of the library is located in RAM, you
  807.      will find a dash (minus sign) here, because in this case it's
  808.      unimportant how many jump addresses point into RAM.
  809.  
  810. ln_Type
  811.      Type of this structure (usually library)
  812.  
  813. Actions
  814. -------
  815.  
  816. Priority
  817.      Herewith the priority of the library can be changed.  A little
  818.      window will be opened, that asks you for a new priority.  Through
  819.      the new priority it can happen that the library gets a new place
  820.      in the list of libraries.
  821.  
  822. Close
  823.      A library must be closed by all programs, if you want to remove it
  824.      from system. In this case the OpenC is zero.
  825.  
  826.      If you select this function, you will be asked, how often you want
  827.      to close it. You can choose between Once and All.
  828.  
  829.      Select All and the library will so often be closed till the
  830.      OpenC is zero.
  831.  
  832. Remove
  833.      The selected library will be removed with this function provided
  834.      that no program uses this library anymore and the OpenC is zero.
  835.  
  836.      Some libraries can't be removed from system without a reset.  So
  837.      you shouldn't wonder about it, if this happens.
  838.  
  839. Functions
  840.      All library function offsets and addresses are shown up in a
  841.      subwindow.  If an appropriate .fd file exists and an FD:
  842.      assign points to its directory, then you will also see the
  843.      function names.
  844.  
  845. Update
  846.      The list of libraries will be updated.
  847.  
  848. Print
  849.      This function allows you to send the list of Libraries to
  850.      printer or a selected file.
  851.  
  852. More
  853.      A window will be opened that includes more details of the library.
  854.  
  855. Exit
  856.      Selecting this gadget will close the library window.
  857.  
  858. Locks
  859. =====
  860.  
  861.    A lock structure shows you, that a program reads from or perhaps
  862. write into a file or a directory.  With this type of structure the
  863. system prevents, that a file will be deleted while another program gets
  864. some data from it.
  865.  
  866. Column items
  867. ------------
  868.  
  869. Access
  870.      Here you can see the type of access.  This could be READ,
  871.      WRITE or OWN.  OWN stands for a lock Scout created to
  872.      get the elements of this list.
  873.  
  874. Path
  875.      Path of the file or directory
  876.  
  877. Actions
  878. -------
  879.  
  880. Update
  881.      The list of Locks will be updated.
  882.  
  883. Print
  884.      This function allows you to send the list of Locks to printer or
  885.      a selected file.
  886.  
  887. Remove
  888.      A lock will be removed through dos.library's `UnLock()' function.
  889.  
  890. Pattern
  891.      If you give Scout a pattern, only the locks with a matching path
  892.      will be shown.
  893.  
  894. Exit
  895.      The Locks window will be closed.
  896.  
  897. LowMemory
  898. =========
  899.  
  900.    This list contains all low memory handler known to the system.
  901.  
  902.    These handlers are called in their sequence if a memory allocation
  903. is about to fail due to missing resources. The handlers try to free as
  904. much unused memory space as possible.
  905.  
  906.    `ramlib' is such a low memory handler removing unused libraries and
  907. devices from the system's memory. It is always present.
  908.  
  909.        Note: Low memory handlers are only available since AmigaOS 3.0.
  910. On older systems this list will always be empty.
  911.  
  912. Column items
  913. ------------
  914.  
  915. Address
  916.      Address of the low memory handler structure.
  917.  
  918. ln_Name
  919.      Name of the handler.
  920.  
  921. ln_Type
  922.      Type of the handler.
  923.  
  924. ln_Pri
  925.      Priority of the handler. All handlers are called in their priority
  926.      sequence.
  927.  
  928. is_Data
  929.      A pointer to some handler's private data.
  930.  
  931. is_Code
  932.      A pointer to the low memory handler code.
  933.  
  934. Actions
  935. -------
  936.  
  937. Update
  938.      The list will be actualized.
  939.  
  940. Print
  941.      This function allows you to send the list to printer or a selected
  942.      file.
  943.  
  944. Remove
  945.      The low memory handler will be removed from system.
  946.  
  947. Priority
  948.      Changes the priority of the selected handler.
  949.  
  950. Exit
  951.      The window will be closed.
  952.  
  953. Memory
  954. ======
  955.  
  956.    In this list you will find the segments of your memory.  At least you
  957. will find an entry for your chip memory.
  958.  
  959. Column items
  960. ------------
  961.  
  962. ln_Name
  963.      Name of the memory segment (e.g. chip memory)
  964.  
  965. ln_Pri
  966.      Priority of memory
  967.  
  968. mh_Lower
  969.      First address of memory
  970.  
  971. mh_Upper
  972.      Last address of memory
  973.  
  974. Actions
  975. -------
  976.  
  977. Print
  978.      This function allows you to send the list of the memory segments to
  979.      printer or a selected file.
  980.  
  981. Priority
  982.      This function allows you to change the priority of a memory
  983.      segment.  The memory segment with the highest priority will be
  984.      preferred from system, provided that no certain type of memory is
  985.      demanded.
  986.  
  987. More
  988.      Another window will be opened. This window includes more
  989.      information about the memory segment.
  990.  
  991. Exit
  992.      The window will be closed.
  993.  
  994. Mounted Devices
  995. ===============
  996.  
  997.    In this list you will find all your devices like disk drives, printer
  998. devices, etc.
  999.  
  1000. Column items
  1001. ------------
  1002.  
  1003. Name
  1004.      Name of the device
  1005.  
  1006. Unit
  1007.      Unit number
  1008.  
  1009. Heads
  1010.      Number of heads
  1011.  
  1012. Cyl
  1013.      Number of cylinders
  1014.  
  1015. State
  1016.      The state shows you for example, if a disk is in drive.
  1017.  
  1018. DiskType
  1019.      Type of a disk (e.g. OFS (OldFileSystem), FFS (FastFileSystem),
  1020.      ...)
  1021.  
  1022. Handler or Device
  1023.      The handler or the device you find here has to manage the stream of
  1024.      data from and to the device.
  1025.  
  1026. Actions
  1027. -------
  1028.  
  1029. Update
  1030.      The list will be updated.
  1031.  
  1032. Print
  1033.      This function allows you to send the list of Mounted Devs to
  1034.      printer or a selected file.
  1035.  
  1036. Exit
  1037.      The window will be closed.
  1038.  
  1039. Ports
  1040. =====
  1041.  
  1042. Programs are able to communicate together through ports.
  1043.  
  1044. Column items
  1045. ------------
  1046.  
  1047. Address
  1048.      Here you will find the port structure.
  1049.  
  1050. ln_Name
  1051.      Name of port
  1052.  
  1053. ln_Pri
  1054.      Priority of port
  1055.  
  1056. mp_SigTask
  1057.      The task is communicating through the port.
  1058.  
  1059. Actions
  1060. -------
  1061.  
  1062. Update
  1063.      The ports list will be updated.
  1064.  
  1065. Print
  1066.      This function allows you to send the list of Ports to printer or
  1067.      a selected file.
  1068.  
  1069. Remove
  1070.      The port will be removed.
  1071.  
  1072. Priority
  1073.      Herewith the port priority can be changed.
  1074.  
  1075. Exit
  1076.      The Ports window will be closed.
  1077.  
  1078. Resident Commands
  1079. =================
  1080.  
  1081.    This list includes all resident commands. That means all commands you
  1082. find in ROM and the commands you made `resident' through the
  1083. resident command.
  1084.  
  1085. Positions and sizes of their hunks you will find here, too.
  1086.  
  1087. Column items
  1088. ------------
  1089.  
  1090. Name
  1091.      Name of the command
  1092.  
  1093. UseCount
  1094.      Here you can see, how often a command was being executed at the
  1095.      time the list was build.
  1096.  
  1097. Lower
  1098.      First address of hunk in memory
  1099.  
  1100. Upper
  1101.      Last address of hunk in memory
  1102.  
  1103. Size
  1104.      Size of hunk (upper - lower - 8 bytes overhead)
  1105.  
  1106. Actions
  1107. -------
  1108.  
  1109. Update
  1110.      The list of Resident Commands will be updated.
  1111.  
  1112. Print
  1113.      This function allows you to send the list of Resident
  1114.      Commands to printer or a selected file.
  1115.  
  1116. Remove
  1117.      The selected command will be removed with this function provided
  1118.      that no program uses this command anymore and the UseCount is
  1119.      zero.
  1120.  
  1121. Exit
  1122.      The window disappears.
  1123.  
  1124. Residents
  1125. =========
  1126.  
  1127.    Resident modules are reset-protected segments (code and data).  In
  1128. the list of Residents you usually find libraries, devices and
  1129. resources.  A programmer has the possibility to make his own programs
  1130. reset-protected.  He has to initialize a resident structure for it and
  1131. then he can link the program through the kick-vectors (see Vectors) to
  1132. the list of the resident modules.  The residents you linked to system
  1133. are usually located in RAM and are of a different color.
  1134.  
  1135.    If you find a resident module that points into RAM and you don't know
  1136. which program has created it, you should start your favourite virus
  1137. detector and let it check your memory.  Many viruses prefer this way to
  1138. travel around.
  1139.  
  1140. Column items
  1141. ------------
  1142.  
  1143. Address
  1144.      At this address the resident module is located.
  1145.  
  1146. ln_Name
  1147.      Name of the resident module
  1148.  
  1149. rt_Pri
  1150.      Priority
  1151.  
  1152. rt_IdString
  1153.      Identity string of the resident module.
  1154.  
  1155. Actions
  1156. -------
  1157.  
  1158. Update
  1159.      The list of Residents will be updated.
  1160.  
  1161. Print
  1162.      This function allows you to send the list of Residents to
  1163.      printer or a selected file.
  1164.  
  1165. More
  1166.      Selecting this gadget opens a new window with more information
  1167.      about the selected resident module.
  1168.  
  1169. Exit
  1170.      The Residents window will be closed.
  1171.  
  1172. Resources
  1173. =========
  1174.  
  1175.    Usually a resource is -- like a library (see Libraries) -- a
  1176. collection of functions/procedures, which have to do certain jobs.
  1177.  
  1178.    E.g. the `filesystem.resource' includes functions for the filesystem
  1179. handling.
  1180.  
  1181. Column items
  1182. ------------
  1183.  
  1184. Address
  1185.      Address of the resource structure
  1186.  
  1187. ln_Name
  1188.      Name of a resource
  1189.  
  1190. ln_Pri
  1191.      Priority of a resource
  1192.  
  1193. OpenC
  1194.      This element shows how often the resource was opened.
  1195.  
  1196. RPC
  1197.          RPC means RAM Pointer Count and shows how many jump
  1198.      addresses of the resource point into RAM.  In this way many
  1199.      programs -- like the setpatch command from Commodore -- patch the
  1200.      system.
  1201.  
  1202.      Many viruses patch the system in this way too, but don't panic now.
  1203.      If you check your system in regular intervals with a current virus
  1204.      killer, it should be out of danger.
  1205.  
  1206.      If the whole program code of the resource is located in RAM, you
  1207.      will find a dash (minus sign) here, because in this case it's
  1208.      unimportant how many jump addresses point into RAM.
  1209.  
  1210. ln_Type
  1211.      Type of this structure (usually resource)
  1212.  
  1213. Actions
  1214. -------
  1215.  
  1216. Update
  1217.      The list of Resources will be updated.
  1218.  
  1219. Print
  1220.      This function allows you to send the list of Resources to
  1221.      printer or a selected file.
  1222.  
  1223. Remove
  1224.      The selected resource will be removed with this function, provided
  1225.      that no program uses it anymore and the OpenC is zero.
  1226.  
  1227. Priority
  1228.      Herewith the priority of the resource can be changed. A small
  1229.      window will be opened, that asks you for a new priority. Through
  1230.      the new priority it can happen that the resource gets a new
  1231.      position in the list of resources.
  1232.  
  1233. More
  1234.      Select this gadget and you get a new window with more information
  1235.      about the selected resource.
  1236.  
  1237. Functions
  1238.      All resource function offsets and addresses are shown up in a
  1239.      subwindow.  If an appropriate .fd file exists and an FD:
  1240.      assign points to its directory, then you will also see the
  1241.      function names. Note that some resources do not have functions.
  1242.  
  1243. Exit
  1244.      The Resources window will be closed.
  1245.  
  1246.        Please note: If you should find three dashes (minus signs) at
  1247. OpenC and/or RPC, the resource has no typical library structure.
  1248. This happens for example at the `FileSystem.resource'.
  1249.  
  1250. ScreenMode
  1251. ==========
  1252.  
  1253.    Screen modes define all monitor resolutions that the system is able
  1254. to show up.
  1255.  
  1256.    You surely have already selected a screen mode before. In this list,
  1257. you will find all available modes. Most of the programs filter out some
  1258. of them when they do not meet their purpose.
  1259.  
  1260. Column items
  1261. ------------
  1262.  
  1263. ModeID
  1264.      An identification number, unique to each mode.
  1265.  
  1266. Width
  1267.      Nominal width of the resolution in pixeln.
  1268.  
  1269. Height
  1270.      Nominal height of the resolution in pixeln.
  1271.  
  1272. Depth
  1273.      Maximum number of planes. The amount of colors which can be
  1274.      simultaneously displayed depends on this.
  1275.  
  1276. ScreenMode
  1277.      Name of the screen mode. Some modes do not have a real name, so
  1278.      Scout will generate it. Then it might differ from the name
  1279.      generated by other programs or screen mode requesters.
  1280.  
  1281. Actions
  1282. -------
  1283.  
  1284. Update
  1285.      The list will be updated.
  1286.  
  1287. Print
  1288.      This function allows you to send the list to printer or a selected
  1289.      file.
  1290.  
  1291. More
  1292.      Further information about the screen mode are displayed in a
  1293.      subwindow. This includes the overscan resolutions and the
  1294.      frequencies. Due to an inaccuracy of the operating system, the
  1295.      real frequencies might be a little bit different to those
  1296.      displayed.
  1297.  
  1298. Exit
  1299.      The window will be closed.
  1300.  
  1301. Semaphores
  1302. ==========
  1303.  
  1304.    The use of semaphores is a way of single-threading critical
  1305. sections.  For example only one program is allowed to use the printer
  1306. at one time, otherwise the texts would be mixed.
  1307.  
  1308. Column items
  1309. ------------
  1310.  
  1311. ln_Name
  1312.      Name of a semaphore
  1313.  
  1314. Nest
  1315.      This item counts how often the semaphore has been obtained by the
  1316.      owner task.
  1317.  
  1318. Queue
  1319.      This counter shows you, how many programs want to obtain the
  1320.      semaphore.
  1321.  
  1322. Owner
  1323.      Here you will find the name of the task that owns the semaphore.
  1324.  
  1325. Actions
  1326. -------
  1327.  
  1328. Update
  1329.      The list of Semaphores will be updated.
  1330.  
  1331. Print
  1332.      This function allows you to send the list of Semaphores to
  1333.      printer or a selected file.
  1334.  
  1335. Obtain
  1336.      This function is used to gain access to a semaphore.  The
  1337.      NestCnt will be increased at one by this call.
  1338.  
  1339. Release
  1340.      Herewith you can make a signal semaphore available to others.
  1341.  
  1342. Exit
  1343.      The Semaphores window will be closed.
  1344.  
  1345. System
  1346. ======
  1347.  
  1348. Actions
  1349. -------
  1350.  
  1351. Print
  1352.      This function allows you to send the list to printer or a selected
  1353.      file.
  1354.  
  1355. Exit
  1356.      The window will be closed.
  1357.  
  1358. Entry items
  1359. -----------
  1360.  
  1361.    In this window you will find some (partially technical) information
  1362. about your computer. Please excuse the ordinary look of the window, but
  1363. it is very easy to add more lines this way.
  1364.  
  1365. Tasks
  1366. =====
  1367.  
  1368.    In this window you find a list of all tasks and processes being in
  1369. system. Each program you start will be executed as a task or process.
  1370.  
  1371. Column items
  1372. ------------
  1373.  
  1374. ln_Name
  1375.      Name of the task/process
  1376.  
  1377. ln_Type
  1378.      Type of the structure (task or process)
  1379.  
  1380. ln_Pri
  1381.      Priority of the task/process
  1382.  
  1383. NUM
  1384.      If a non detaching program was started from shell, you will find
  1385.      here the number of the process. Programs you started from
  1386.      Workbench have a dash here.
  1387.  
  1388. State
  1389.      Here you see the state of the task or process. You will find
  1390.      Scout's own process on the top of the list with a run at this
  1391.      place, because this process is always running when it gets the
  1392.      task list.
  1393.  
  1394.          ready means the task wants to work, but it's interrupted by
  1395.      the execution of another task.
  1396.  
  1397.      A task that is waiting for a certain signal is in the state
  1398.      wait. In this case it doesn't need processing time.
  1399.  
  1400. SigWait
  1401.      Signalmask the task is waiting for.
  1402.  
  1403. Actions
  1404. -------
  1405.  
  1406. Print
  1407.      This function allows you to send the list of Tasks to printer or
  1408.      a selected file.
  1409.  
  1410. Freeze
  1411.      With this function you freeze the selected task. It can still be
  1412.      found in the list of tasks, but it gets no processing time from
  1413.      system.
  1414.  
  1415.               Warning: If you try to freeze tasks essential to the
  1416.           system like `input.device', you should have saved all
  1417.           important data, cause a RESET is the only way out!
  1418.  
  1419. Activate
  1420.      A frozen task can be activated here.
  1421.  
  1422. CPU
  1423.      Here you will find a text field and a cycle gadget. This text field
  1424.      displays -- dependent on the state of the cycle gadget -- the CPU
  1425.      load in percent.
  1426.  
  1427.      For the cycle gadget you can choose between three states:
  1428.     off
  1429.           In this case the CPU load won't be displayed. If you select
  1430.           another state, Scout will patch some system functions to
  1431.           calculate the CPU load of all tasks.
  1432.  
  1433.     full
  1434.           If you select this state, Scout sets the real cpu load to
  1435.           100%.  That means the total of the CPU loads of all tasks and
  1436.           processes will be 100%. Therefore nothing will be displayed
  1437.           in the text field.
  1438.  
  1439.     in %
  1440.               Scout starts a task named « Scout's cheat task » to
  1441.           calculate the real CPU load and it will be displayed in the
  1442.           text field.
  1443.  
  1444. Secs
  1445.      This string gadget allows you to set the intervall time for
  1446.      updating of the CPU load display.
  1447.  
  1448. Update
  1449.      The list will be updated.
  1450.  
  1451. Remove
  1452.      A task will be removed from the list.  You should prefer the freeze
  1453.      function, if you perhaps need this task again.
  1454.  
  1455.      See also Break!
  1456.  
  1457. Signal
  1458.      If you select a signal mask, it will be send to the task.
  1459.  
  1460. Break
  1461.      A signal mask that includes the signals CTRL-C and CTRL-D will be
  1462.      send to the task you selected.  Many tasks and processes end, if
  1463.      they receive these signals.
  1464.  
  1465. Priority
  1466.      The priority of a task can be changed with this function.
  1467.  
  1468. More
  1469.      Selecting this gadget will open another window that displays more
  1470.      informations about the task or the process.
  1471.  
  1472. Exit
  1473.      The window will be closed.
  1474.  
  1475. Timer
  1476. =====
  1477.  
  1478.    This window lists all current requests of the timer.device.
  1479.  
  1480. Column items
  1481. ------------
  1482.  
  1483. Address
  1484.      Address of the IO request structure.
  1485.  
  1486. ReplyPort
  1487.      Address of the port the request will be replied to.
  1488.  
  1489. Time
  1490.      Time that this request will stay in this list.
  1491.  
  1492. Unit
  1493.      There are two different measures: VBlank (which has less overhead)
  1494.      and MicroHz (which is more accurate).
  1495.  
  1496. Task
  1497.      Name of the requesting task.
  1498.  
  1499. Actions
  1500. -------
  1501.  
  1502. Print
  1503.      This function allows you to send the list to printer or a selected
  1504.      file.
  1505.  
  1506. Update
  1507.      The list will be updated.
  1508.  
  1509. Exit
  1510.      The window will be closed.
  1511.  
  1512. Vectors
  1513. =======
  1514.  
  1515. Actions
  1516. -------
  1517.  
  1518. Update
  1519.      The displayed vectors will be updated.
  1520.  
  1521. Print
  1522.      This function allows you to send the list of Vectors to printer
  1523.      or a selected file.
  1524.  
  1525. Exit
  1526.      The window will be closed.
  1527.  
  1528. Reset Vectors
  1529. -------------
  1530.  
  1531.    A program can make itself reset-protected by using the reset vectors.
  1532. If the vectors are unused, they have a value of zero. The programs
  1533. which use the Kick-Vectors (KickTagPtr, KickMemPtr and KickCheckSum)
  1534. can also be found in the list of resident structures.  See also
  1535. Residents.
  1536.  
  1537. Auto Vector Interrupts
  1538. ----------------------
  1539.  
  1540.    In a computer system with a MC68000 processor you will find the seven
  1541. Auto Vector Interrupts from address $64 to address $7c. Higher
  1542. processors (MC68010, etc.) have the VBR (Vector Base Register) that
  1543. allows you to move the interrupt table to FAST-MEM. The system will be
  1544. a little bit faster then. Scout uses the VBR if it exists.
  1545.  
  1546. Interrupt Vectors
  1547. -----------------
  1548.  
  1549.    Here you see 16 interrupt vectors (IntVecs). These vectors are
  1550. located in the `ExecBase' (base structure of the exec.library).
  1551.  
  1552. Windows
  1553. =======
  1554.  
  1555.    All screens with the windows opened on them are listed here. Screens
  1556. are of a different color as windows.
  1557.  
  1558. Column items
  1559. ------------
  1560.  
  1561. Pos(x,y)
  1562.      x and y position of the screen/window
  1563.  
  1564. Size(x,y)
  1565.      x and y size of the screen/window
  1566.  
  1567. Title
  1568.      Title of the screen/window
  1569.  
  1570. Actions
  1571. -------
  1572.  
  1573. Update
  1574.      The list will be updated.
  1575.  
  1576. Print
  1577.      This function allows you to send the list of Windows to printer
  1578.      or a selected file.
  1579.  
  1580. Close
  1581.      With this function it is possible to close screens and/or windows.
  1582.      If you close a screen, all windows on it will be closed too.
  1583.  
  1584. To Front
  1585.      The selected screen/window will be popped to front.
  1586.  
  1587. More
  1588.      If you select this gadget another window will be opened that
  1589.      displays more informations about the window or the screen.
  1590.  
  1591. Exit
  1592.      The window will be closed.
  1593.  
  1594. Scout and AmiTCP
  1595. ================
  1596.  
  1597.    This section will show you what you have to do for using Scout as
  1598. a TCP/IP service through AmiTCP. Nearly all functions of Scout can
  1599. also be used via AmiTCP.
  1600.  
  1601.    Now some knowledge will be assumed. If you don't know, what kind of
  1602. program AmiTCP represents, you should read AmiTCP's user's manual
  1603. before. (See also AmiTCP.)
  1604.  
  1605.    If you have installed AmiTCP, you can use Scout as client and
  1606. server. Except the installed programs of AmiTCP you don't need
  1607. another program for using Scout on networks.
  1608.  
  1609.    If you want to make your computer available for other systems on the
  1610. network, you have to do following two steps:
  1611.  
  1612.   1. Add the line scout 6543/tcp to file AmiTCP:db/services.
  1613.  
  1614.   2. Now please add the line scout stream tcp nowait root
  1615.      dh0:scout to file AmiTCP:db/inetd.conf. Make sure that the path
  1616.      at the end of this line is the right path for scout.
  1617.  
  1618.    That's it! If you start AmiTCP now, your computer is available for
  1619. other systems through using the options HOST, USER and
  1620. PASSWORD.
  1621.  
  1622.       Example: If I want perform some actions on some system
  1623.      structures of my own system for example, I have to start
  1624.      Scout through something like:
  1625.  
  1626.      1> scout HOST crash.north.de USER atte PASSWORD secret
  1627.  
  1628.    If you leave out option PASSWORD, you will be asked for the
  1629. correct password through the password: prompt. In this case nobody
  1630. can see your password, because it won't be displayed in shell.
  1631.  
  1632.    If you don't use option USER, AmiTCP takes the username that is
  1633. actually available in system.
  1634.  
  1635.    The usage of AmiTCP doesn't provide the installation of MUI. All
  1636. of Scout's shell commands (see also Commands) can be used via network
  1637. through AmiTCP.
  1638.  
  1639.       Example: If I want to get the task list of my system, I have to
  1640.      use something like:
  1641.  
  1642.      1> scout HOST crash.north.de USER atte PASSWORD secret Tasks
  1643.  
  1644.    You and all other users must always identify themselves through
  1645. their usernames (option USER) and their passwords (option
  1646. PASSWORD).  It's also possible to allow or deny certain systems
  1647. the usage of some services through the file AmiTCP:db/inet.access.
  1648. See also the user's manual of AmiTCP.
  1649.  
  1650.    If you want to get more informations about the implemented options
  1651. and commands, you should also see Options and Commands.
  1652.  
  1653.        NOTE: Please take care that the remote system runs the latest
  1654. Scout version as well, to avoid incompatibilities.
  1655.  
  1656. Scout without MUI
  1657. =================
  1658.  
  1659.    Nearly all through the graphical user interface available functions
  1660. of Scout are also available via shell. Therefore you don't really
  1661. need MUI for using Scout. But if you want to use Scout's
  1662. graphical user interface, you must have MUI in your system.
  1663.  
  1664. Options
  1665. *******
  1666.  
  1667.    There are some options for Scout which you can use, when you start
  1668. the program.  The following options are available from shell and as
  1669. tool types from Workbench.
  1670.  
  1671. ICONIFIED
  1672.          Usage: ICONIFIED
  1673.  
  1674.      If this option is activ, Scout starts iconified.
  1675.  
  1676. PORTNAME
  1677.          Usage: PORTNAME=portname
  1678.  
  1679.      The name of Scout's ARexx port can be changed into portname.
  1680.      Without this option the ARexx port is called `SCOUT.X'. The X
  1681.      stands for a decimal number that will be incremented, if a so
  1682.      called port already exists.
  1683.  
  1684. TOOLPRI
  1685.          Usage: TOOLPRI=value
  1686.  
  1687.      This option allows you to change the priority of Scout's process
  1688.      into value.
  1689.  
  1690. STARTUP
  1691.          Usage: STARTUP=command
  1692.  
  1693.      The variable command should be an ARexx script or a single ARexx
  1694.      command. Both (script or command) will be executed, when
  1695.      Scout will be started. In this way you can open more than
  1696.      only the main window by starting. Try for example the command
  1697.      OpenWindow Tasks and you will get two windows by starting
  1698.      (the main window and the task list window).
  1699.  
  1700.      (See also Commands.)
  1701.  
  1702. INTERVALTIME
  1703.          Usage: INTERVALTIME=seconds
  1704.  
  1705.      This options allows you to save your preferred update time for the
  1706.      list of tasks.  (See also Tasks.)
  1707.  
  1708. CPUDISPLAY
  1709.          Format: CPUDISPLAY=value
  1710.  
  1711.      Through the variable value you can select the state of the
  1712.      CPU cycle gadget you find in the Tasks window.  (See also
  1713.      Tasks.)
  1714.  
  1715.         * 1  means  CPU: full
  1716.  
  1717.         * 2  means  CPU: in %
  1718.  
  1719. HOST
  1720.          Format: HOST=hostname
  1721.  
  1722.      This options allows you to specify the system (hostname) you
  1723.      want to manipulate via network through AmiTCP.
  1724.  
  1725. USER
  1726.          Format: USER=username
  1727.  
  1728.      You have to use this option to identify yourself by using
  1729.      Scout as a TCP/IP service.
  1730.  
  1731. PASSWORD
  1732.          Format: PASSWORD=password
  1733.  
  1734.      Without a password Scout can't connect to another system via
  1735.      network. This option allows you to set the correct password.
  1736.  
  1737. COMMAND
  1738.          Format: COMMAND=commandline
  1739.  
  1740.      Nearly all of Scout's implemented functions are available from
  1741.      shell through this option. You don't need the COMMAND key to use
  1742.      this option. (See also Commands.)
  1743.  
  1744. SINGLEWINDOWS
  1745.          Format: SINGLEWINDOWS
  1746.  
  1747.      Some users don't like to handle the many windows of Scout. This
  1748.      option solves the problem of too many windows. If this option is
  1749.      selected, only one list window and only one detail window is
  1750.      opened at a time.
  1751.  
  1752. SORT#?TYPE
  1753.          Format: SORT#?TYPE=number
  1754.  
  1755.      Many of Scout's lists have a cycle gadget below themselves. With
  1756.      these gadgets you can select, how a certain list will be sorted.
  1757.  
  1758.          SORT#?TYPE stands for each of the following options:
  1759.        SORTLIBRARIESTYPE, SORTDEVICESTYPE,
  1760.        SORTRESOURCESTYPE, SORTTASKSTYPE, SORTPORTSTYPE,
  1761.        SORTCOMMANDSTYPE, SORTASSIGNSTYPE, SORTLOCKSTYPE,
  1762.        SORTCOMMODITIESTYPE, SORTSCREENMODETYPE and SORTCLASSESTYPE.
  1763.  
  1764.          SORT#?TYPE should follow a decimal number, which selects the
  1765.      kind of sorting.
  1766.  
  1767.      Here are some examples for the list of tasks:
  1768.  
  1769.        SORTTASKSTYPE=1 the tasks will be sorted by their names.
  1770.        SORTTASKSTYPE=2 the tasks will be sorted by their priorities.
  1771.  
  1772. Scout's commands via ARexx and shell
  1773. ************************************
  1774.  
  1775.     Scout supports two kinds of commands:
  1776.  
  1777.   1. commands only available from shell
  1778.  
  1779.   2. commands available from ARexx and shell
  1780.  
  1781. ARexx port
  1782. ----------
  1783.  
  1784.    It's a feature of MUI to give each application its own ARexx port.
  1785. Therefore Scout also has an ARexx port that usually has the name
  1786. SCOUT.X. The X stands for a decimal number that will be
  1787. incremented, if a so called port already exists.
  1788.  
  1789.    You will find the name of Scout's ARexx port in the window you
  1790. get, if you select the Project/About menu.
  1791.  
  1792. Using tasknames:
  1793. ----------------
  1794.  
  1795.    If a task or a process was started from shell and hasn't detached
  1796. itself, you will find the name of the command being executed, where
  1797. usually the taskname is displayed.  The real name of those tasks
  1798. usually is something like Background CLI, but such a taskname isn't
  1799. useful.
  1800.  
  1801.          Example: If you start a non detaching task like
  1802.      DH0:Debug/Sushi from shell, you will see
  1803.      DH0:Debug/Sushi as taskname.
  1804.  
  1805.    Some ARexx commands need a taskname as parameter. You have to select
  1806. those from CLI started self detaching tasks by using their command
  1807. names like Scout displays them in the lists of tasks.
  1808.  
  1809. Commands only available from shell
  1810. ==================================
  1811.  
  1812. Help
  1813.          Format: Help
  1814.  
  1815.      This command is the most important one and it doesn't need
  1816.      parameters.  If you try Help, Scout prints a list of all
  1817.      available commands to shell.  =:^)
  1818.  
  1819.    Now 18 commands follow. These commands allow the user to get all
  1820. lists of system structures from shell. Therefore you only need to
  1821. install MUI for using Scout's graphical user interface.
  1822.  
  1823.    Each of the following commands has a shortened form that stands
  1824. behind the command in parentheses.
  1825.  
  1826.          Allocations (a), BoopsiClasses (b), Commands (c),
  1827.      Devices (d), Timer (e), Fonts (f), Assigns (g),
  1828.      InputHandlers (h), Interrupts (i), LowMemory (j),
  1829.      Commodities (k), Libraries (l), Memory (m), Mounts (n),
  1830.      Locks (o), Ports (p), Residents (r), Semaphores (s),
  1831.      Tasks (t), Resources (u), Vectors (v), Windows (w),
  1832.      Expansions (x), System (y) and ScreenMode (z).
  1833.  
  1834.       Example: To get the list of ports, you only have to use scout
  1835.      ports or scout p from shell.
  1836.  
  1837. Commands available from ARexx and shell
  1838. =======================================
  1839.  
  1840. FindTask
  1841.          Usage: FindTask task
  1842.  
  1843.      This command allows you to check, if task task exists in system
  1844.      or not. The result is the address of the task task, if it has
  1845.      been found. task can be the name or the address of a task.
  1846.  
  1847. FreezeTask
  1848.          Usage: FreezeTask task
  1849.  
  1850.      The task taskname will be frozen. After that it will still be
  1851.      found in system's task list, but then it doesn't need processing
  1852.      time.  You can choose the name or the address of a task for
  1853.      task.
  1854.  
  1855. ActivateTask
  1856.          Usage: ActivateTask task
  1857.  
  1858.      If task task was frozen, it will be activated, otherwise an
  1859.      error occured. task is again a task's name or an address.
  1860.  
  1861. RemoveTask
  1862.          Usage: RemoveTask task
  1863.  
  1864.      This command removes the task task. It's lost forever.
  1865.  
  1866. BreakTask
  1867.          Usage: BreakTask task
  1868.  
  1869.          Scout sends the task task a certain signal mask that
  1870.      includes the signals CTRL-C and CTRL-D. Many programs support
  1871.      these signals and finish themselves, if they receive one of them.
  1872.  
  1873. SignalTask
  1874.          Usage: SignalTask task hexsignal
  1875.  
  1876.      This command allows you to send a signal hexsignal to the task
  1877.      task. The signal must specified as a hexadecimal number.
  1878.  
  1879.          Example:
  1880.           SendSignal 'scout' 0x001000
  1881.      sends task scout a CTRL-C and after that Scout ends.
  1882.  
  1883. SetTaskPri
  1884.          Usage: SetTaskPri task priority
  1885.  
  1886.      The task task gets a new priority (priority).
  1887.  
  1888. RemovePort
  1889.          Usage: RemovePort port
  1890.  
  1891.      The port port will be removed from Scout. port can be the
  1892.      name of a port or its address.
  1893.  
  1894. GetLockNumber
  1895.          Usage: GetLockNumber lockpattern
  1896.  
  1897.      This command returns the number of locks which have paths matching
  1898.      to the pattern lockpattern.
  1899.  
  1900.          Example: Use the command
  1901.           GetLockNumber 'WORK:Utilities/#?'
  1902.      and you will know, how many locks are currently used for files in
  1903.      the directory WORK:Utilities/.
  1904.  
  1905. RemoveLocks
  1906.          Usage: RemoveLocks lockpattern
  1907.  
  1908.      Use this command and all locks which have paths matching to the
  1909.      pattern lockpattern will be removed.  (See also
  1910.      GetLockNumber.)
  1911.  
  1912. RemoveLock
  1913.          Format: RemoveLock lockaddress
  1914.  
  1915.      The lock at adress lockaddress will be removed.
  1916.  
  1917. FindNode
  1918.          Usage: FindNode nodetype nodename
  1919.  
  1920.      This command allows you to find a certain node. You only have to
  1921.      know its name (nodename) and its type (nodetype).
  1922.  
  1923.          Nodetype can have following values:  LIBRARY, DEVICE,
  1924.      RESOURCE, MEMORY, SEMAPHORE, PORT or INPUTHANDLER.
  1925.  
  1926.          Example: If you want to get the address of the
  1927.      disk.resource you must use:
  1928.           FindNode RESOURCE 'disk.resource'
  1929.  
  1930. GetPriority
  1931.          Usage: GetPriority nodeaddress
  1932.  
  1933.      This command allows you to check the priority of a certain node
  1934.      structure. This includes all following structure types:  tasks,
  1935.      libraries, devices, resources, ports, residents, input handlers,
  1936.      interrupts, semaphores and the elements of the memory list.
  1937.  
  1938.      You only have to know the address (nodeaddress) of that
  1939.      structure.
  1940.  
  1941.          Example: The following ARexx commands store the priority of
  1942.      your chip memory in the variable pri:
  1943.           FindName MEMORY 'chip memory'
  1944.           addr = result
  1945.           GetPriority addr
  1946.           pri = result
  1947.  
  1948. SetPriority
  1949.          Usage: SetPriority nodetype nodename
  1950.  
  1951.      If you want to change the priority of the node nodename, you can
  1952.      use this command.  Again nodetype can have following values:
  1953.      LIBRARY, DEVICE, RESOURCE, MEMORY, SEMAPHORE, PORT or
  1954.      INPUTHANDLER.
  1955.  
  1956. CloseLibrary
  1957.          Format: CloseLibrary library
  1958.  
  1959.      The library library will be closed once. library can be the
  1960.      name of the library or its address.
  1961.  
  1962. RemoveLibrary
  1963.          Format: RemoveLibrary library
  1964.  
  1965.      The library library will be removed, if no program uses it.
  1966.  
  1967. RemoveDevice
  1968.          Format: RemoveDevice device
  1969.  
  1970.      The selected device device will be removed. For device use the
  1971.      name or the address of the device.
  1972.  
  1973. RemoveResource
  1974.          Format: RemoveResource resource
  1975.  
  1976.      The resource resource will be removed.
  1977.  
  1978. ObtainSemaphore
  1979.          Format: ObtainSemaphore semaphore
  1980.  
  1981.      This command allows you to obtain the given semaphore.
  1982.      semaphore can be the semaphore's name or address.
  1983.  
  1984. ReleaseSemaphore
  1985.          Format: ReleaseSemaphore semaphore
  1986.  
  1987.      The semaphore semaphore will be once released.
  1988.  
  1989. RemoveSemaphore
  1990.          Format: RemoveSemaphore semaphore
  1991.  
  1992.      You are able to remove the semaphore semaphore by using this
  1993.      command.
  1994.  
  1995. RemoveInputhandler
  1996.          Format: RemoveInputhandler inputhandler
  1997.  
  1998.      The input handler inputhandler selected through name or address
  1999.      will be removed.
  2000.  
  2001. FindResident
  2002.          Usage: FindResident resident
  2003.  
  2004.      This command returns the address of the resident structure
  2005.      resident.
  2006.  
  2007. FindInterrupt
  2008.          Usage: FindInterrupt interruptname
  2009.  
  2010.      The address of the interrupt interruptname will be returned.
  2011.  
  2012. RemoveInterrupt
  2013.          Format: RemoveInterrupt interruptname
  2014.  
  2015.      The interrupt you have selected through interruptname will be
  2016.      removed.
  2017.  
  2018. FlushDevs
  2019.          Usage: FlushDevs
  2020.  
  2021.      All not used devices will be removed. The used memory will be
  2022.      freed.
  2023.  
  2024. FlushFonts
  2025.          Usage: FlushFonts
  2026.  
  2027.      If a diskfont is in memory, but no program uses it, it will be
  2028.      removed.
  2029.  
  2030. FlushLibs
  2031.          Usage: FlushLibs
  2032.  
  2033.      All not used libraries will be removed. The used memory will be
  2034.      freed.
  2035.  
  2036. FlushAll
  2037.          Usage: FlushAll
  2038.  
  2039.      This function includes FlushDevs, FlushFonts and
  2040.      FlushLibs. All not used devices, libraries and fonts will be
  2041.      removed and the used memory will be freed.
  2042.  
  2043. ClearResetVectors
  2044.          Usage: ClearResetVectors
  2045.  
  2046.      The six reset vectors will be cleared, if you select this function
  2047.      (see Vectors).
  2048.  
  2049. PopToFront
  2050.          Usage: PopToFront title
  2051.  
  2052.      This command allows you to pop a screen or window to front. You
  2053.      only have to know its (title).
  2054.  
  2055. CloseWindow
  2056.          Usage: CloseWindow windowtitle
  2057.  
  2058.      This command closes the window that is specified through its title
  2059.      (windowtitle).
  2060.  
  2061. CloseScreen
  2062.          Usage: CloseScreen screentitle
  2063.  
  2064.      If you select this command, the screen (screentitle) will be
  2065.      closed with all its windows.
  2066.  
  2067. CloseFont
  2068.          Format: CloseFont address
  2069.  
  2070.      The font at address address will be closed once.
  2071.  
  2072. RemoveFont
  2073.          Format: RemoveFont address
  2074.  
  2075.      This command removes the font at address address, if it's not
  2076.      used by any program.
  2077.  
  2078. RemoveCommand
  2079.          Format: RemoveCommand address
  2080.  
  2081.          Scout makes the resident command at address address not
  2082.      resident.
  2083.  
  2084. RemoveAssign
  2085.          Format: RemoveAssign name
  2086.  
  2087.      With this command you're able to remove the assign name.
  2088.  
  2089. RemoveAssignList
  2090.          Format: RemoveAssignList name address
  2091.  
  2092.      This command removes the directory at address address from
  2093.      assign name. You will find the address of that directory in the
  2094.      list of assigns.
  2095.  
  2096. PrintList
  2097.          Format: PrintList listcharacter filename
  2098.  
  2099.      This command allows you to print a list (specified by the
  2100.      listcharacter) into the file filename.
  2101.  
  2102.          Example:
  2103.           PrintList t 'ram:tasklist'
  2104.      will print the list of tasks into the file 'ram:tasklist'.
  2105.  
  2106. OpenWindow
  2107.          Usage: OpenWindow windowid
  2108.  
  2109.      All windows you get if you select a gadget of Scout's main
  2110.      window, can be opened with this command.  The windowid is the
  2111.      same text you find on the main window gadgets.
  2112.  
  2113.          Example:
  2114.           OpenWindow 'Mounted Devs'
  2115.      will open the window with the list of mounted devices.
  2116.  
  2117. CxAppear
  2118. CxDisappear
  2119. CxEnable
  2120. CxDisable
  2121. CxKill
  2122. CxListChg
  2123. CxUnique
  2124.          Format: Cx... name
  2125.  
  2126.      Sends the command to the commodity named name.
  2127.  
  2128. RemoveCx
  2129.          Format: RemoveCx commodity
  2130.  
  2131.      Removes the appropriate commodity from the list. Please consider
  2132.      this as `emergency break'. Use it only if CxKill failed.
  2133.  
  2134. SetCxPri
  2135.          Format: SetCxPri commodity priority
  2136.  
  2137.      Sets the priority of a commodity.
  2138.  
  2139. RemoveClass
  2140.          Format: RemoveClass class
  2141.  
  2142.      The appropriate BOOPSI class is removed, if no objects and no
  2143.      subclasses are existing.
  2144.  
  2145. How to get updates
  2146. ==================
  2147.  
  2148.    The newest version of Scout should always be available on AmiNet
  2149. or Public Domain collections, which are up-to-date.
  2150.  
  2151.    You can also find the latest version on my home page:
  2152.          http://www.is-koeln.de/einwohner/shred/
  2153.  
  2154. Credits
  2155. =======
  2156.  
  2157.    Now we have to thank some people for supporting the development of
  2158. Scout on many different kinds:
  2159.  
  2160.    * Klaus `gizmo' Weber, he was always available to Atte and his many
  2161.      questions (not a few) during the programming of Scout.
  2162.  
  2163.    * Christian `cosinus' Stelter, he gave the permission to use his
  2164.      many manuals.
  2165.  
  2166.    * Stefan Stuntz for his great MagicUserInterface
  2167.  
  2168.    * all (hopefully still) bug reporting and feature requesting people:
  2169.      Kai `wusel' Siering, Martin Hauner, Peter Meyer, Karl `Charly'
  2170.      Skibinski, Michael `Mick' Hohmann, Thore Böckelmann, Bernardo
  2171.      Innocenti, Daniel Lundberg, ...
  2172.  
  2173.      and last but not least
  2174.  
  2175.    * all the others we've forgotten for reporting bugs, sending
  2176.      expansion boards data and so on.
  2177.  
  2178. How to reach the author
  2179. =======================
  2180.  
  2181.    If you have questions, suggestions, bug reports or anything else, you
  2182. can contact me at:
  2183.  
  2184.  
  2185.                          Richard Körber
  2186.                          Hornstraße 20
  2187.                     51465 Bergisch Gladbach
  2188.                           - Germany -
  2189.      
  2190.                  E-Mail: shred@chessy.aworld.de
  2191.                          richard.koerber@koeln.netsurf.de
  2192.  
  2193.    Send E-Mails whenever possible..
  2194.  
  2195.    If you want to contact Andreas Gelhausen, you can reach him at:
  2196.  
  2197.  
  2198.                        Andreas Gelhausen
  2199.                        Graf Spee Str. 23b
  2200.                        26123 Oldenburg
  2201.                           - Germany -
  2202.      
  2203.                   E-Mail: atte@crash.north.de
  2204.  
  2205.    Please do not contact him for bug reports, suggestions and similar.
  2206. But if you feel the urge to send a gift, then he is the right address!
  2207.  
  2208. That's it!  =:^)
  2209.  
  2210. Index
  2211. *****
  2212.  
  2213.  
  2214.  
  2215.  Allocations                            Allocations
  2216.  AmiTCP                                 AmiTCP
  2217.  ARexx                                  Commands
  2218.  ARexx port                             Commands
  2219.  Assigns                                Assigns
  2220.  Author Info                            Author Info
  2221.  Boards                                 Expansions
  2222.  BoopsiClasses                          BoopsiClasses
  2223.  Command                                Commands
  2224.  Command Line Options                   Options
  2225.  Commodities                            Commodities
  2226.  Contents                               Copyright
  2227.  Copying                                Copyright
  2228.  Copyright                              Copyright
  2229.  Copyright                              Copyright
  2230.  Credits                                Credits
  2231.  Device names, logical                  Assigns
  2232.  Devices                                Devices
  2233.  DISKFONT                               Fonts
  2234.  Distribution                           Copyright
  2235.  Expansions                             Expansions
  2236.  Fonts                                  Fonts
  2237.  FreeWare                               Copyright
  2238.  Handler, LowMemory                     LowMemory
  2239.  Hardware                               Expansions
  2240.  Identify                               Identify
  2241.  Input events                           InputHandlers
  2242.  InputHandlers                          InputHandlers
  2243.  Installation                           Installation
  2244.  Interrupts                             Interrupts
  2245.  Introduction                           Introduction
  2246.  Legalities                             Copyright
  2247.  Liability                              Copyright
  2248.  Libraries                              Libraries
  2249.  Limitation                             Copyright
  2250.  Locks                                  Locks
  2251.  Logical device names                   Assigns
  2252.  LowMemory                              LowMemory
  2253.  MagicUserInterface                     MUI
  2254.  Main Window                            Using Scout
  2255.  Manufacturer                           Expansions
  2256.  Memory                                 Memory
  2257.  Mounted Devices                        Mounted Devs
  2258.  MUI                                    MUI
  2259.  No Warranty                            Copyright
  2260.  Options                                Options
  2261.  Ports                                  Ports
  2262.  Processes                              Tasks
  2263.  RAM Pointer Count                      Devices
  2264.  Resident Commands                      Resident Cmds
  2265.  Residents                              Residents
  2266.  Resource allocation                    Allocations
  2267.  Resources                              Resources
  2268.  ROMFONT                                Fonts
  2269.  RPC                                    Devices
  2270.  ScreenMode                             ScreenMode
  2271.  Screens                                Windows
  2272.  Semaphores                             Semaphores
  2273.  System                                 System
  2274.  System Requirements                    System Requirements
  2275.  Tasknames                              Commands
  2276.  Tasks                                  Tasks
  2277.  TCP/IP                                 AmiTCP
  2278.  Timer                                  Timer
  2279.  Tool Types                             Options
  2280.  Trademarks                             Copyright
  2281.  Updates                                Updates
  2282.  Using Scout                            Using Scout
  2283.  VBR                                    Vectors
  2284.  Vectors                                Vectors
  2285.  Vertical blank interrupt               Interrupts
  2286.  What is Scout?                         Introduction
  2287.  Windows                                Windows
  2288.  
  2289.